iT邦幫忙

2025 iThome 鐵人賽

DAY 3
0
佛心分享-SideProject30

30天的旅程!從學習C#到開發小專案系列 第 3

DAY 3 - ASP.NET Core Web API 架構揭秘(上)

  • 分享至 

  • xImage
  •  

哈囉大家好!
來到鐵人賽的第三天啦~今天要嘗試建立第一個ASP.NET Core專案!
之後的小專案想要前後端分離開發,所以我要建立的Web API作為後端。
那就馬上開始吧~

1. 準備好需要的工具

首先需要一個開發環境,可以選擇使用Visual Studio或Visual Studio Code。
因為我主要使用的IDE是VSCode,所以接下來的步驟會以VSCode開發環境為主!
除此之外,也要安裝VSCode中的C#開發套件:C# Dev Kit還有.NET 9.0 SDK

2. 建立API專案

準備好工具後就可以開始創建專案了!
將路徑切換到想要建立專案的資料夾中,透過命令列來快速建立:

dotnet new web -o myExampleApi
cd myExampleApi

註:命令列中的-o為--output的縮寫,後面接受的是路徑字串,也就是專案建立的位置。
如果我想要把API放進統一的allApi資料夾,我也可以寫成:

dotnet new web -o ./allApi/myExampleApi

接著就可以在IDE打開對應的資料夾,就可以看見專案的架構如下:

- myExampleApi/
    ├── bin/
    ├── obj/
    ├── Properties/
    ├── appsettings.Development.json
    ├── appsettings.json
    ├── myExampleApi.csproj
    ├── myExampleApi.sln
    ├── Program.cs

首先來看看各個資料夾和檔案裡有什麼內容:

1. bin/:

存放編譯後的輸出檔案,可以透過dotnet builddotnet publish指令來編譯程式碼。不同的編譯方式會產生對應的資料夾,像dotnet build對應產生Debug/ , dotnet publish 則是產生Release/。

- dotnet build

通常在開發階段,會執行dotnet build來編譯程式碼,產生可以在開發環境中執行與測試的檔案。執行後產出的內容有:

  • 編譯後的.dll檔
  • 其他中繼檔
  • 非可部署版本,需要.NET Runtime才能執行,所以執行完dotnet build後要執行dotnet run來啟動應用程式!

- dotnet publish

執行dotnet publish後,會產生一個完整且可以部署的應用程式~
當需要把應用程式部署到雲端或伺服器上時,就可以執行這個指令!
執行後產出的內容有:

  • 編譯後的.dll檔和.exe檔
  • 應用程式需要的依賴(dependency),例如:NuGet套件

2. obj/:

這裡會存放編譯過程中的暫存檔,通常開發時不需要特別修改或查看這裡的資料。


剩下的資料夾和檔案明天會一起看完,希望透過瞭解專案架構可以更加熟悉ASP.NET Core以及理解執行每個指令的意義~
那就明天見啦 8181/images/emoticon/emoticon29.gif


上一篇
DAY 2 - 認識.NET 和 ASP.NET Core框架
下一篇
DAY 4 - ASP.NET Core Web API 架構揭秘(下)
系列文
30天的旅程!從學習C#到開發小專案4
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言